home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 001 / remote.arc / REMOTE.DOC < prev    next >
Text File  |  1985-03-08  |  16KB  |  377 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                               REMOTE Version 1.08
  30.                                  by Greg Haley
  31.  
  32.                                                                               1
  33.                                  INTRODUCTION
  34.  
  35.   This program provides tty communications for the TIPC.
  36. Although the program is copyrighted, this program is NOT to be sold. 
  37. Users may copy and distribute the program and documentation freely.
  38. REMOTE's features include:
  39.  
  40.  1) Runs under MS-DOS version 1.25 or greater.
  41.  2) Supports the TI internal modem, Hayes external modem, or direct connection.
  42.  3) Maintains a Dialing Directory.
  43.  4) 300 - 19200 baud operation.
  44.  5) Tone or pulse auto dial. (both modems)
  45.  6) Auto re-dial. (both modems)
  46.  7) Busy handling.
  47.  8) Full or half duplex operation. (Can be changed on-line)
  48.  9) On-line selection of carriage return/linefeed sequence.
  49. 10) On-line data capture.
  50. 11) ASCII and XMODEM file transfer.
  51. 12) Directory listing with file size.
  52. 13) Communication status report.
  53. 14) Character filtering for incoming characters.
  54. 15) Optional port search.
  55. 16) Status line that displays the current state of various parameters.
  56. 17) Four user-programmable function keys.
  57.  
  58.                                                                               2
  59.                                 Getting Started
  60.  
  61. This disk should contain 3 files:
  62. REMOTE.DOC    (This file)
  63. REMOTE.EXE    (Executable file)
  64. REMOTE.DIR     (Sample dialing directory)
  65.  
  66.  
  67. EXTERNAL MODEM SET-UP:
  68.  If a Hayes Smartmodem 1200 is used, set the switches as follows:
  69.      switch #1: up          (supports DTR lead)
  70.      switch #2: up          (word result codes)
  71.      switch #3: down        (send result codes)
  72.      switch #4: up          (echos characters in command state)
  73.      switch #5: up          (auto-answer on)
  74.      switch #6: down        (holds carrier detect true)
  75.      switch #7: don't care  (phone line dependent)
  76.      switch #8: down        (enables 1200 command recognition)
  77.  
  78. If any other external modem is used, be sure to set the carrier signal 
  79. true at all times. Also please note that if your modem can't accept 
  80. 'ATDT' or 'ATDP' as dialing prefixes, auto dialing can't be used. 
  81. The same holds true if a carriage return can't be used as the dialing 
  82. suffix or if the modem does not return the words 'NO CARRIER' or 'CONNECT' 
  83. to indicate auto-dial completion. See the section on manual dialing.
  84.  
  85.                                                                               3
  86.  
  87.                              The Dialing Directory
  88.  
  89.   When REMOTE begins execution, and after each disconnection, the dialing
  90. directory is displayed. Up to 60 entries can be made. The name of each entry
  91. is displayed. To dial, press the F1 key, then type the entry's number and 
  92. press ENTER. REMOTE will now dial the phone number. If a connection is not 
  93. made, it will delay for about 5 seconds and re-dail the number. This loop 
  94. continues until a connection is made or until the user aborts by pressing 
  95. the F12 key. Please note that it may take several seconds to abort; so be 
  96. patient. If you're using an internal modem, a message is displayed after 
  97. every call indicating if the line was busy, the phone wasn't answered, etc.. 
  98. If you're using a Hayes external modem, you'll be able to hear the call 
  99. through the modem's speaker.
  100.   To add, delete, or modify a directory entry, press the F5 key. You will 
  101. then be asked which number you want to modify. Type the number and the 
  102. parameters for that entry are displayed. Make any changes you wish by using 
  103. the arrow keys and typing in information. (See the section on modifying 
  104. directory entries). When you are done making changes, press the F1 key to 
  105. save the changes, or press the F12 key to delete the entry from the directory.
  106.   A directory entry may also be deleted by pressing the F8 key rather than
  107. the F5 (modify) key. You'll be asked which number to delete.
  108.   The dialing directory may be sorted by pressing the F4 key. Sorting is
  109. done automatically and the dialing directory file is updated after the sort.
  110.   To exit REMOTE, press the F12 key anytime the dialing directory is displayed.
  111. Also please note that the dialing directory is stored in the file 'REMOTE.DIR'.
  112. If this file is missing or not in the default directory, REMOTE will create
  113. a new, empty dialing directory.
  114.  
  115.  
  116. MODIFYING DIRECTORY ENTRIES:
  117.   After you enter the modify mode within the dialing directory, the screen
  118. is cleared and the set-up parameters for the selected directory entry are
  119. displayed. You may save the parameters at any time by pressing F1; or you
  120. may delete the entry from the directory by pressing F12. You must use one
  121. of these keys to exit the modify mode. 
  122.   To change any of the parameters, move the cursor to the desired field by
  123. pressing the ARROW keys. Some fields (like the phone number field) require
  124. that you enter information from the keyboard. Other fields (like the port
  125. number) are selected merely by pointing at them using the arrow keys.
  126. Remember, the parameters are not saved until you press the F1 key.
  127.   The fields Name, Phone Number, and Shift F1 - Shift F4 all require you to
  128. enter information, so we'll discuss each of them seperately. Full editing
  129. is available on all these fields. (See the section on special key functions)
  130.  
  131. Name:
  132.   This is the name that is displayed on the dialing directory listing.
  133. Any upper or lower case alpha-numeric character may be entered here.
  134. However, the first character may not be a blank space.
  135.  
  136.                                                                               4
  137. Phone Number:
  138.   Enter the phone number here; or if you wish REMOTE to answer the phone,
  139. leave this field blank. The phone number may consist of the numbers
  140. 0 - 9 and the characters "-,+()*#". Spaces may be entered but are deleted
  141. automatically when you save the entry or move to another field. 
  142.   Please note that the character "+" means wait for dial tone with the 
  143. internal modem, but the Hayes uses the "," character for the same purpose.
  144. To provide compatibility, the "," character is automatically substituted
  145. in place of the "+" character when dialing with an external modem.
  146. This means you may use the "+" character for either modem!
  147. Shift F1 - Shift F4:
  148.   These are the user defined function keys. Any characters entered will
  149. be sent to the other computer whenever the key is pressed. These keys
  150. are useful for storing user id's and passwords, or frequently used
  151. keystrokes. Any upper or lower case alpha numeric character may be entered
  152. here. In addition, the backslash character ("\") is used to indicate a
  153. carraige return - line feed sequence. 
  154.  
  155.  
  156. SPECIAL KEY FUNCTIONS:
  157.   Some keys have special functions while in the modify mode. Here's a list
  158. of them and what they do:
  159.  
  160. KEY                   FUNCTION
  161. ----------------      ----------------------------------------
  162. UP ARROW              Moves to the previous field.
  163. DOWN ARROW            Moves to the next field.
  164. SHIFT UP ARROW        Moves to the first field. (Name)
  165. SHIFT DOWN ARROW      Moves to the last field.  (Shift F4)
  166. LEFT ARROW            Moves back one character or selection.
  167. RIGHT ARROW           Moves forward one character or selection.
  168. DEL                   Deletes the character under the cursor.
  169. BACK SPACE            Deletes the character under the cursor and moves
  170.                       back one character.
  171. INS                   Enters insert mode.
  172. SHIFT LEFT ARROW      Moves to the first position of the field.
  173. HOME                  Same as SHIFT LEFT ARROW.
  174. SHIFT RIGHT ARROW     Moves to the last position of the field.
  175. SHIFT DEL             Deletes all the characters from the cursor
  176.                       to the end of the field.
  177. F1                    Saves the parameters as displayed.
  178. F12                   Deletes the entry from the directory listing.
  179.  
  180.  
  181. AUTOMATIC DIALING:
  182.   REMOTE will auto-dial if a phone number has been specified and the modem
  183. type was not NONE. It will continue to dial until a connection is made or
  184. the user aborts by pressing the F12 key. 
  185.  
  186.  
  187. MANUAL DIALING:
  188.   If you have an external modem that can't accept Hayes commands for auto
  189. dialing, or you wish to do your own dialing, specify 'N' (no modem) for the 
  190. modem type. If you're using an internal modem, you have 20 seconds to dial 
  191. the number before the modem times out. If you're using a Hayes Smartmodem,
  192. you may type the command 'ATDT' (for tone dialing) or 'ATDP' (for pulse
  193. dialing) and the phone number, followed by a carriage return.
  194.  
  195.                                                                               5
  196. PORT SEARCH:
  197.   If you specify '?' for the port number, the program will search all four 
  198. possible ports, skipping unused ports, until it finds the modem.
  199. This option is NOT recommended unless your modem is the only port on your TIPC.
  200. This option will not work if you specify NONE for the modem type.
  201.  
  202.                                                                               6
  203.                                  Function Keys
  204.  
  205.  
  206. F1 - Open/Close Capture File:
  207.   This key opens a capture file if none is open, or closes the capture
  208. the if it is open. The current state is always displayed. If the capture
  209. file is opened, the user is prompted for the file name.
  210.  
  211. F2 - Capture On/Off:
  212.   This key toggles the capture on and off. It's current state is always
  213. displayed. An error message is returned if no capture file is open.
  214. This key is useful for capturing only those portions of a session that 
  215. you are interested in.
  216.  
  217. F5 - Send File:
  218.   This key is used to send a file to the other computer. When you press
  219. this key, you are prompted for the file transfer type (ASCII or XMODEM).
  220. After chosing the type, you're asked for the file name. If you chose
  221. ASCII file transfer, you'll aslo be asked for the number of nulls to use.
  222. Typing a number from 0 to 9 will set the transmission speed. (0 is fastest,
  223. 9 the slowest). This feature is useful for transferring files to slower host
  224. computers. 
  225.  
  226. F6 - Receive File:
  227.   Use this function to transfer files to the other computer. As with Send
  228. File, you're prompted for the transmission type and file name. Please note
  229. that ASCII file receive stops when a CONTROL Z (end of file) character is
  230. received or until you press F8.
  231.  
  232. F8 - Abort File Transfer:
  233.   Press this key to abort either ASCII or XMODEM file transfers. It may
  234. take several seconds for the transfer to abort.
  235.  
  236. F9 - Linefeeds On/Off:
  237.   Toggles the linefeed character on and off. It's current state is always
  238. displayed. When Linefeed is ON, all carriage returns sent are followed with
  239. a linefeed. When linefeed is OFF, a single carriage return is sent as the
  240. end of line sequence.
  241.  
  242. F10 - Full/Half Duplex:
  243.   This mode toggles the duplex mode between full and half duplex. If you
  244. can't see what you're typing, try turning duplex to half.
  245. Please note that in half duplex mode the computer also echoes all received
  246. characters back to the host computer. Since most modems operate in half
  247. duplex mode, it is recommended that you set the duplex to FULL until a
  248. connection is made. 
  249.  
  250. F11 - Send CONTROL C:
  251.   Pressing this key sends a CONTROL C character to the other computer.
  252. Do NOT press the CTRL C key as this may cause the program to terminate. 
  253.  
  254. F12 - Hang Up:
  255.   This key is used to disconnect and return to the dialing directory.
  256. Pressing this key while REMOTE is connecting will abort the connection.
  257.  
  258.                                                                               7
  259. ALT C - Clear the Screen:
  260.   Press this key whenever you wish to clear the screen during a session.
  261.  
  262. ALT D - Directory listing:
  263.   Use this key to get a directory listing. You'll be prompted for the 
  264. filespec. You may abort the directory by pressing either the F8 key or 
  265. the ESC key. All file sizes are rounded off to the nearest 1000 bytes.
  266.  
  267. ALT G - Get Screen:
  268.   This function copies the screen to the capture file, if one is open.
  269.  
  270. ALT H - Help Menu:
  271.   Pressing this key will display a help menu that lists all the function
  272. keys that are'nt displayed in the status line. 
  273.  
  274. ALT P - Print Screen:
  275.   This function prints the screen.
  276.  
  277. ALT S - View Communication Status:
  278.   Use this key to check for communication errors. This function displays
  279. the number of parity, framing, and overrun errors encountered since
  280. the connection began. Also displayed is the number of busy's sent and
  281. received; but this is meaningless if no busy handling was selected.
  282.   
  283.  
  284. CHARACTER FILTERING:
  285.  The following incoming characters are not printed on the screen or sent to
  286. the capture file:
  287.  
  288.   Character    ASCII Code
  289.   -----------------------
  290.   NUL        0
  291.   CTRL A    1
  292.   CTRL B    2
  293.   CTRL C    3
  294.   CTRL D    4
  295.   CTRL E    5
  296.   CTRL F    6
  297.   CTRL N    14
  298.   CTRL O    15
  299.   CTRL P    16
  300.   CTRL Q    17
  301.   CTRL R    18
  302.   CTRL S    19
  303.   CTRL T    20
  304.   CTRL U    21
  305.   CTRL V    22
  306.   CTRL W    23
  307.   CTRL X    24
  308.   CTRL Y    25
  309.   CTRL Z    26
  310.   ESC        27
  311.   FS        28
  312.   GS        29
  313.   RS        30
  314.   US        31
  315.  
  316. No character filtering is done on the keyboard or during file transfer.
  317.  
  318.                                                                               8
  319. DISCONNECTING:
  320.   Anytime you are online and the carrier drops, this program will terminate.
  321. You may force a disconnection at any time by pressing the F12 key.
  322. After disconnection, REMOTE displays the communication status report, then 
  323. asks you to press the RETURN key to continue. When you've finished reading 
  324. the communication stats, press RETURN to go back to the dialing directory. 
  325.  
  326.  
  327. STATUS REPORTING:
  328.   At disconnection, the program returns the number of busy's sent, the number
  329. of busy's received, and the number of receive errors detected.
  330. The current status may be viewed at any time during a session by pressing
  331. the ALT S key.
  332.  
  333.                                                                               9
  334.                                REMOTE Revisions
  335.  
  336. Version 1.08 - Linked with new ACS library.
  337.  
  338. Version 1.07 - Sped up the port search.
  339.                Function keys and the prompt 'Connecting...' are now displayed
  340.                while REMOTE is dialing or waiting for a connection.
  341.                Added a prompt after disconnect. This replaces the old delay
  342.                and lets the user read or ignore the stats report.
  343.  
  344. Version 1.06 - Added the characters # and * to the phone number character set. 
  345.                Increased the number of directory entries to 60.
  346.                Increased the dialing directory's screen access speed.
  347.                Added a dialing directory sort.
  348.                Added port search for the external modem.
  349.  
  350. Version 1.05 - Fixed transmit buffer queue bug.
  351.  
  352. Version 1.04 - Fixed XMODEM queue bug.
  353.  
  354. Version 1.03 - Added print screen and capture screen functions.
  355.                Changed directory routine to prompt for a filespec rather
  356.                than just a drive name.
  357.  
  358. Version 1.02 - Fixed Hayes auto-dial bug @ 300 baud.
  359.                Changed code so an error message is always displayed,
  360.                never an error code.
  361.  
  362. Version 1.01 - Added the clear screen function.
  363.                Changed code so that all characters sent or received over
  364.                the communications port are printed in light blue; all
  365.                prompts, error messages, and operator inputs are printed
  366.                in white.
  367.  
  368.                                                                              10
  369. Any suggestions or comments on this software should be sent to:
  370.  
  371.                                   Greg Haley
  372.                             Texas Instruments, Inc.
  373.                           Personal Computer Services
  374.                          Defense Suppression Division
  375.                             P.O. Box 405  M/S 3405
  376.                             Lewisville, Texas 75067
  377.